home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / emula / 551conv.lha / 551conv.doc < prev   
Text File  |  1996-12-18  |  3KB  |  70 lines
  1. 551conv is a program to convert various atari-800-diskformats, for example
  2. to use them in an emulator or POKEYNoise.
  3.  
  4. Version:
  5. 1.00beta.
  6.  
  7. Requirements:
  8. Amiga with Kick 1.3 or higher.
  9.  
  10. Guarantees:
  11. Since this program is freeware, no guarantee for properly work is given,
  12. although I did my best to eliminate all errors. Also I take no 
  13. responsibility for any damages caused by the program.
  14.  
  15. Usage of 551conv:
  16. 551conv -[s|d][a|d|f|x]<device|path|file> -[s|d][a|d|f|x]<device|path|file>
  17. Ok, lets explain it...
  18. 551conv            clearly, i think
  19. -            clear too
  20. s|d            source or destination
  21. a|d|f|x            .atr or real_disk or all_files_of_the_dir or .xfd
  22. <device|path|file>    the d-option requires a diskdrive
  23.             the a- and x-option requires a filename
  24.             the f-option requires a device or directory
  25. Limitations:
  26. Until now, a real_disk can be used only as source (if you need *really*
  27. writing of a real_disk so tell me) and all_files_of_the_dir can be used only
  28. as destination (same note as on real_disk).
  29.  
  30. Some examples:
  31. 551conv -sdDF2: -dxram:mynicedisk.xfd
  32.     converts a real atari-disk from DF2: into an .xfd image on ram:
  33. 551conv -saram:mynicedisk.atr -dfdh1:atarifiles/
  34.     converts all files of an .atr disk image to dh1:atarifiles/
  35.  
  36. Note:
  37. There are 4 different formats of the new atari-800-disk-drive XF551 (they
  38. will be recognized automatically):
  39. single with 128 bytes x 18 sectors x 40 tracks x 1 side, fm-coded
  40. medium with 128 bytes x 26 sectors x 40 tracks x 1 side, mfm-coded
  41. double with 256 bytes x 18 sectors x 40 tracks x 1 side, mfm-coded
  42. quad   with 256 bytes x 18 sectors x 40 tracks x 2 sides, mfm-coded
  43. The quad-format from only the XF551 will be converted correctly - that disk
  44. drive uses side 2, track 40, sector 18 as logical sector $2d1 and 
  45. side 2, track 1, sector 1 as logical sector $5a0 - and theres no way to 
  46. check if that is correct (means you'll get crap when you try to convert 
  47. a such-formatted disk which was NOT written with the XF551).
  48. That converter supports on double-density-disks only the correct .atr-format
  49. which saves the sectors 1-3 in a length of 128 bytes and then sector 4 until 
  50. end in the correct sectorlength (means, no fillbytes are included like in 
  51. some weird .atr-files). Thats the same behaviour as the XF551 drive has.
  52. Although every I/O is done with os-functions, it may happen that real-disk
  53. reading wont work with some Amiga-Clones, and it will probably not work 
  54. with the Unix Amiga Emulator (cause it uses very low os-functions, like
  55. raw disktrack reading).
  56.  
  57. Known Bugs:
  58. On reading real disks (option d), giving a nonexistent drive lets crash 
  59. the program (when i have time, i'll fix it).
  60.  
  61. Author:
  62.     Achim Härtel
  63.     A.-Dürer-Str. 60
  64.     09366 Stollberg
  65.  
  66. E-mail: (Valid until 04/1997) achim.haertel@e-technik.tu-chemnitz.de
  67.  
  68. Other programs from me:
  69. POKEYNoise - an atari-800-soundchipemulator for DeliTracker.
  70.